home *** CD-ROM | disk | FTP | other *** search
/ PCBoard 15.1 Demo / PCBoard v15.1 DEMO - Clark Dev. Co (1994) - Disk 1 of 1.imd / PCBDISK.EXE / WHATSNEW.PPL < prev    next >
Encoding:
Text File  |  1994-02-14  |  29.4 KB  |  774 lines
  1. | A vertical bar denotes changes since the last posting of the file.
  2. |
  3. | Current Posting Dated: 01/21/94
  4.  
  5.  WHATSNEW in the PCBoard Programming Language (PPL) version 2.00:
  6.  ----------------------------------------------------------------
  7.  
  8.  - The following new types have been added to PPL 2.00:
  9.  
  10.      BIGSTR   -> Allows up to 2048 characters per big string
  11.                    (up from 256 for STRING variables)
  12.                  May include CHR(0) characters in the middle of the big string
  13.                    (unlike STRING variables which may not)
  14.  
  15.      EDATE    -> Julian date in earth date format
  16.                  Deals with dates formatted YYMM.DD
  17.                  Range:  Same as DATE
  18.  
  19.      REAL     -> 4-byte floating point number
  20.                  Range:  +/-3.4E-38 - +/-3.4E+38 (7-digit precision)
  21.  
  22.      DREAL    -> 8-byte floating point number
  23.                  Range:  +/-1.7E-308 - +/-1.7E+308 (15-digit precision)
  24.  
  25.      FLOAT    -> 4-byte floating point number        (same as REAL)
  26.                  Range:  +/-3.4E-38 - +/-3.4E+38 (7-digit precision)
  27.  
  28.      DOUBLE   -> 8-byte floating point number        (same as DREAL)
  29.                  Range:  +/-1.7E-308 - +/-1.7E+308 (15-digit precision)
  30.  
  31.      UNSIGNED -> 4-byte unsigned integer
  32.                  Range:  0 - 4,294,967,295
  33.  
  34.      BYTE     -> 1-byte unsigned integer
  35.                  Range:  0 - 255
  36.  
  37.      WORD     -> 2-byte unsigned integer
  38.                  Range:  0 - 65,535
  39.  
  40.      DWORD    -> 4-byte unsigned integer             (same as UNSIGNED)
  41.                  Range:  0 - 4,294,967,295
  42.  
  43.      UBYTE    -> 1-byte unsigned integer             (same as BYTE)
  44.                  Range:  0 - 255
  45.  
  46.      UWORD    -> 2-byte unsigned integer             (same as WORD)
  47.                  Range:  0 - 65,535
  48.  
  49.      UDWORD   -> 4-byte unsigned integer             (same as UNSIGNED)
  50.                  Range:  0 - 4,294,967,295
  51.  
  52.      SBYTE    -> 1-byte signed integer
  53.                  Range:  -128 - 127
  54.  
  55.      SWORD    -> 2-byte signed integer
  56.                  Range:  -32,768 - 32,767
  57.  
  58.      SDWORD   -> 4-byte signed integer               (same as INTEGER)
  59.                  Range:  -2,147,483,648 - 2,147,483,647
  60.  
  61.      SHORT    -> 1-byte signed integer               (same as SBYTE)
  62.                  Range:  -128 - 127
  63.  
  64.      INT      -> 2-byte signed integer               (same as SWORD)
  65.                  Range:  -32,768 - 32,767
  66.  
  67.      LONG     -> 4-byte signed integer               (same as INTEGER)
  68.                  Range:  -2,147,483,648 - 2,147,483,647
  69.  
  70.  - Added a BREAK statement which can be used to break out of a WHILE or FOR
  71.      loop without the use of a GOTO statement
  72.  
  73.  - Added a QUIT statement which can be used to break out of a WHILE or FOR
  74.      loop without the use of a GOTO statement (alias for BREAK)
  75.  
  76.  - Added a CONTINUE statement which can be used to abort the current iteration
  77.      of a WHILE or FOR loop and resume with the next iteration of the loop
  78.  
  79.  - Added a LOOP statement which can be used to abort the current iteration
  80.      of a WHILE or FOR loop and resume with the next iteration of the loop
  81.      (alias for CONTINUE)
  82.  
  83.  - Modified FCLOSE to accept channel -1 as the READLINE() function
  84.      'channel' and close it
  85.  
  86.  - Added a FFLUSH statement to flush a specified channels changes to disk
  87.  
  88.      Usage:  FFLUSH channel
  89.  
  90.  - Added a FSEEK statement to position to any random location within a file
  91.  
  92.      Usage:  FSEEK channel,bytes,position
  93.  
  94.              bytes is the number of bytes to move (+/-) relative to position
  95.  
  96.              position is the base location to start the seek from
  97.                (SEEK_SET (0) for the beginning of the file, SEEK_CUR (1) for
  98.                the current file pointer location, SEEK_END (2) for the end of
  99.                the file)
  100.  
  101.  - Added a FREAD statement to read binary data from a file
  102.  
  103.      Usage:  FREAD channel,var,size
  104.  
  105.              var is the variable into which data should be read
  106.  
  107.              size is the size of data to read into var (0 - 2048)
  108.  
  109.  - Added a FWRITE statement to write binary data to a file
  110.  
  111.      Usage:  FWRITE channel,exp,size
  112.  
  113.              exp is the expression whose result should be written
  114.  
  115.              size is the size of data to write to var
  116.  
  117.  - Added a FDEFIN statement to specify a default input file channel
  118.      (used to speed up file input)
  119.  
  120.      Usage:  FDEFIN channel
  121.  
  122.  - Added a FDEFOUT statement to specify a default output file channel
  123.      (used to speed up file output)
  124.  
  125.      Usage:  FDEFOUT channel
  126.  
  127.  - Added the following default channel input statements:  FDGET & FDREAD
  128.    They use the exact same arguments as FGET & FREAD except a channel
  129.      parameter (the channel specified by FDEFIN is assumed)
  130.  
  131.  - Added the following default channel output statements:  FDPUT, FDPUTLN,
  132.      FDPUTPAD, & FDWRITE
  133.    They use the exact same arguments as FPUT, FPUTLN, FPUTPAD, & FWRITE except
  134.      a channel parameter (the channel specified by FDEFOUT is assumed)
  135.  
  136.  - Added a REDIM statement to dynamically redimension an array at
  137.      run-time. To use it you must declare the array in advance with the
  138.      number subscripts desired.  This allows the compiler to perform it's
  139.      standard error checking on subscripts.  For example:
  140.  
  141.      STRING s(1,1,1)
  142.      REDIM s,5,5,5
  143.      LET s(4,4,4) = "Hello, World!"
  144.      PRINTLN s(4,4,4)
  145.  
  146.    If an attempt is made to redimension an array with a different number
  147.      of dimensions, an error or warning (as appropriate) will be
  148.      generated.
  149.  
  150.  - Added an APPEND statement to append the contents of one file to
  151.      another file.  The syntax is:
  152.  
  153.      APPEND "SRCFILE","DSTFILE"
  154.  
  155.  - Added a COPY statement to copy the contents of one file to another
  156.      file.  The syntax is:
  157.  
  158.      COPY "SRCFILE","DSTFILE"
  159.  
  160.  - Added a LASTIN statement to set the users last conference in value. It
  161.      can be used during the logon process to force the user into a
  162.      particular conference at start up (for example, from a logon
  163.      script). The syntax is:
  164.  
  165.      LASTIN 6 ; The user was 'last in' conference 6
  166.  
  167.  - Added a FLAG statement to allow flagging files for download directly
  168.      from a PPE.  The syntax is:
  169.  
  170.      FLAG "C:\PATH\FILENAME.ZIP" ; Or whatever file name desired
  171.  
  172.    Note that FLAG does not attempt to honor restrictions in the FSEC
  173.      and/or DLPATH.LST files.  This allows you to flag up any file
  174.      desired.
  175.  
  176.  - Added a DOWNLOAD statement to allow downloading files from PPL.  The
  177.      syntax is:
  178.  
  179.      DOWNLOAD "CMD;CMD;CMD"
  180.  
  181.    The string passed to DOWNLOAD is a list of commands in the same format
  182.      as what a user would type after a D or DB command.  If a file name
  183.      for download is specified here it must be downloadable according to
  184.      the criteria established in the FSEC and DLPATH.LST files.  If it is
  185.      necessary to download a file not normally available via the FSEC
  186.      and/or DLPATH.LST files the FLAG statement may be used to force it
  187.      into the list of files to download.
  188.  
  189.  - Added a FLAGCNT() function to return the number of files flagged for
  190.      download.
  191.  
  192.  - Added a WRUSYSDOOR statement to write a USERS.SYS file with a TPA
  193.      record for a DOOR application.  The syntax is:
  194.  
  195.      WRUSYSDOOR "DOORNAME"
  196.  
  197.  - Added KBDSTRING statement to stuff strings to the keyboard (just like
  198.      KBDSTUFF except 'keystrokes' are echoed to the display)
  199.  
  200.  - Added a KBDFLUSH statement to flush the local keyboard buffer and any
  201.      stuffed keystroke buffers.  It takes no arguments.
  202.  
  203.  - Added a MDMFLUSH statement to flush the incoming modem buffer.  It
  204.      takes no arguments.
  205.  
  206.  - Added a KEYFLUSH statement to flush both the local buffers and the
  207.      incoming modem buffer.  It takes no arguments.
  208.  
  209.  - Added ALIAS statement to allow PPE control of whether or not the user
  210.      is using an alias
  211.  
  212.  - Added a CONFALIAS() function to return TRUE if the current conference
  213.      is configured to allow aliases
  214.  
  215.  - Added a USERALIAS() function to return TRUE if the current user is
  216.      allowed to use an alias
  217.  
  218.  - Added ALIAS() function to return the users current ALIAS setting
  219.      (TRUE = alias use on, FALSE = alias use off)
  220.  
  221.  - Added LANG statement to change the language in use by the current
  222.      user. The syntax is:
  223.  
  224.      LANG langNum
  225.  
  226.  - Added ADJBYTES statement to adjust the users total and daily download
  227.      bytes.  The syntax is:
  228.  
  229.      ADJBYTES bytes
  230.  
  231.    To subtract bytes use a negative number for bytes.  To add bytes use
  232.      a positive number.
  233.  
  234.  - Added ADJDBYTES statement to adjust the users daily download bytes.
  235.      The syntax is:
  236.  
  237.      ADJDBYTES bytes
  238.  
  239.    To subtract bytes use a negative number for bytes.  To add bytes use
  240.      a positive number.
  241.  
  242.  - Added ADJTBYTES statement to adjust the users total download bytes.
  243.      The syntax is:
  244.  
  245.      ADJTBYTES bytes
  246.  
  247.    To subtract bytes use a negative number for bytes.  To add bytes use
  248.      a positive number.
  249.  
  250.  - Added ADJTFILES statement to adjust the users total download files.
  251.      The syntax is:
  252.  
  253.      ADJTFILES files
  254.  
  255.    To subtract files use a negative number for files.  To add files use
  256.      a positive number.
  257.  
  258.  - Modified the PUTUSER statement to only update user information if a
  259.      successful GETUSER or GETALTUSER was issued previously.  This was
  260.      done to ensure that information for the current user wasn't written
  261.      to another user or vice versa.
  262.  
  263.  - Added PUTALTUSER statement to put user information.  It is merely an
  264.      alias for PUTUSER and may be used anywhere that PUTUSER would be
  265.      used.
  266.  
  267.  - Added GETALTUSER statement to get the information for an alternate
  268.      user.  It will fill the user variables with information from the
  269.      specified user record as well as redirect user statements and
  270.      functions.  Thank David for this one guys, he did the hard work, I
  271.      just hooked it into PPL.  The syntax is:
  272.  
  273.      GETALTUSER userRecordNumber
  274.  
  275.    If an attempt is made to get a record number that doesn't exist, the
  276.      user functions will revert to the current user and the user
  277.      variables will be invalidated as though no GETUSER/GETALTUSER
  278.      statement had been issued (though they will continue to maintain
  279.      any value held). PUTUSER/PUTALTUSER should be issued to commit any
  280.      variable changes to the user record.  Additionally, there is at
  281.      least one statement that will not affect alternate users:  ADJTIME.
  282.      It is restricted to the current user online.  Also, if the
  283.      alternate user is online, changes to the record won't take hold
  284.      until after the user has logged off.  Also, if there is not enough
  285.      memory available (primarily for the last message read pointers)
  286.      this statement will fail.
  287.  
  288.  - Added FREALTUSER to deallocate alternate user information and get the
  289.      information for the current caller.  GETALTUSER must allocate
  290.      memory to hold the alternate user information.  FREALTUSER is used
  291.      to free up that memory for other processes.  Additionally, the
  292.      MESSAGE statement needs to use alternate user information as well
  293.      and can't if the PPE is already using it.  So this statement is
  294.      necessary if a MESSAGE statement needs to be used after a
  295.      GETALTUSER pair.
  296.  
  297.  - Added CURUSER() function to determine what users information, if any,
  298.      is available via the user variables.  It takes no arguments and
  299.      returns one of the following values:
  300.  
  301.      NO_USER (-1) - User variables are currently undefined
  302.      CUR_USER (0) - User variables are for the current user
  303.      Other        - The record number of an alternate user for whom user
  304.                     variables are defined
  305.  
  306.  - Added NO_USER constant (-1) for use with the CURUSER() function
  307.  
  308.  - Added CUR_USER constant (0) for use with the CURUSER() function
  309.  
  310.  - Added U_LMR(confNum) function to return the number of the last
  311.      message read for the specified conference.
  312.  
  313.  - Added KBDBUFSIZE() function to return the number of key presses
  314.      pending in the KBDSTRING buffer.
  315.  
  316.  - Added PPLBUFSIZE() function to return the number of key presses
  317.      pending in the KBDSTUFF buffer.
  318.  
  319.  - Added KBDFILUSED() function to return TRUE if key presses are being
  320.      stuffed via a KBDFILE statement.
  321.  
  322.  - Added LOMSGNUM() function to return the low message number for the
  323.      current conference.
  324.  
  325.  - Added HIMSGNUM() function to return the high message number for the
  326.      current conference.
  327.  
  328.  - Added CHATSTAT() function to return the current users chat
  329.      availability status (TRUE means available, FALSE means
  330.      unavailable).
  331.  
  332.  - Added DEFANS() function to return the last default answer passed to
  333.      an INPUT statement.  For example, this allows a PPE to determine
  334.      what the default answer would have been had a PCBTEXT prompt not
  335.      been replaced with a PPE.
  336.  
  337.  - Added LASTANS() function to return the last answer accepted by an
  338.      INPUT statement.
  339.  
  340.  - Added the following functions to return a users conference flags
  341.      (note that each of these functions takes a single argument which is
  342.      the conference number to check the flag)
  343.  
  344.      CONFREG(confNum) = Returns TRUE if users registered flag is set,
  345.                         FALSE otherwise
  346.  
  347.      CONFEXP(confNum) = Returns TRUE if users expired flag is set,
  348.                         FALSE otherwise
  349.                         (NOTE: CONFREG() = FALSE & CONFEXP = TRUE,
  350.                                            user locked out;
  351.                                CONFREG() = TRUE  & CONFEXP = TRUE,
  352.                                            user reg & exp)
  353.  
  354.      CONFSEL(confNum) = Returns TRUE if user has selected the conference,
  355.                         FALSE otherwise
  356.  
  357.      CONFSYS(confNum) = Returns TRUE if user has conference SysOp access,
  358.                         FALSE otherwise
  359.  
  360.      CONFMW(confNum)  = Returns TRUE if user has mail waiting in conference,
  361.                         FALSE otherwise
  362.  
  363.  - Modified the CCTYPE() function to recognize JCB cards and more Diners
  364.      Club cards to the CCTYPE() function.
  365.  
  366.  - Modified the VALCC() function to strip invalid characters from the
  367.      card number string before attempting to do the checksum.
  368.  
  369.  - Added an ERRCORRECT() function to return TRUE if a session is
  370.      determined to be error corrected (or FALSE for non-error corrected
  371.      sessions).
  372.  
  373.  - Added MIXED() function to convert a string to mixed (or proper name)
  374.      case
  375.  
  376.  - Added LPRINTED() function to return the number of lines printed on the
  377.      display
  378.  
  379.  - Added ISNONSTOP() function to return whether or not the display is
  380.      currently in non-stop mode (ie, did the user type NS as part of
  381.      their command line)
  382.  
  383.  - Added a REPLACESTR function; it functions just like the REPLACE function
  384.      except that a complete sub-string may be specified for both search and
  385.      replace
  386.  
  387.      Usage:  REPLACESTR(str,search,replace) (returns BIGSTR)
  388.  
  389.              str is the string to work on
  390.  
  391.              search is the string to search for
  392.  
  393.              replace is the string to replace search with
  394.  
  395.  - Added a STRIPSTR function; it functions just like the STRIP function
  396.      except that a complete sub-string may be specified for search
  397.  
  398.      Usage:  STRIPSTR(str,search) (returns BIGSTR)
  399.  
  400.              str is the string to work on
  401.  
  402.              search is the string to search for
  403.  
  404.  - Added the following functions (one per type):  TOBOOLEAN, TOMONEY,
  405.      TOSTRING, TOBIGSTR, TOINTEGER, TOUNSIGNED, TOREAL, TODREAL,
  406.      TOFLOAT, TODOUBLE, TODATE, TOEDATE, TOTIME, TOBYTE, TOWORD,
  407.      TODWORD, TOUBYTE, TOUWORD, TOUDWORD, TOSBYTE, TOSWORD, TOSDWORD,
  408.      TOSHORT, TOINT, & TOLONG; they are used to force the result of an
  409.      expression to a specific type
  410.  
  411.      Usage:  TOtype(exp) (returns type)
  412.  
  413.              type is the actual type to force (BIGSTR, BOOLEAN, etc.)
  414.  
  415.              exp is an expression of any type
  416.  
  417.  - Added (or documented) the following operators:
  418.  
  419.      [  -> open  parenthesis (same as ()  (also in 1.00)
  420.      {  -> open  parenthesis (same as ()  (also in 1.00)
  421.      ]  -> close parenthesis (same as ))  (also in 1.00)
  422.      }  -> close parenthesis (same as ))  (also in 1.00)
  423.  
  424.      == ->            equal  (same as =)  (also in 1.00)
  425.      != -> not        equal  (same as <>) (also in 1.00)
  426.      >< -> not        equal  (same as <>) (also in 1.00)
  427.      =< -> less    or equal  (same as <=) (also in 1.00)
  428.      => -> greater or equal  (same as >=) (also in 1.00)
  429.  
  430.      && -> logical and       (same as &)  (also in 1.00)
  431.      || -> logical or        (same as |)  (also in 1.00)
  432.  
  433.      ** -> exponentiation    (same as ^)
  434.  
  435.  - A double quote ("") may be embedded within a string constant to tell
  436.      the compiler that a single literal quote is desired (in other
  437.      words, "THIS""IS""A""TEST" would evaluate to THIS"IS"A"TEST after
  438.      the leading and trailing quotes are removed and the double quotes
  439.      were folded to single quotes)
  440.  
  441.  - Labels and variable names may now include the following characters in
  442.      addition to A-Z, 0-9, and the _ (underscore) character: $ (dollar
  443.      sign), @ (commercial at), # (pound sign), ¢ (cents), £ (british
  444.      pound), ¥ (japanese yen)
  445.  
  446.  - A \ (backslash) character as the last character on a line (before any
  447.      comments) will now allow continuing a logical line from one to the
  448.      next physical line
  449.  
  450.  - A : (colon) character may be used to separate multiple logical lines
  451.      on a single physical line
  452.  
  453.  - PPLC 1.00 would assume a LET statement if LET was not explicitly specified
  454.      in the following cases:
  455.  
  456.      1. The variable name did not match a reserved keyword
  457.  
  458.      2. The variable name was followed immediately (no space) by an equal
  459.         sign (=)
  460.  
  461.    Now the equal sign need not be flush against the variable.  In other
  462.      words, where "DIR = value" would not work before (because "DIR " is
  463.      a reserved keyword), it will work now (because the = before the
  464.      value will implicitly indicate a LET statement to the compiler).
  465.  
  466.  - The following function(s) now take and return BIGSTRs instead of STRINGs:
  467.  
  468.      REPLACE   STRIP   STRIPATX   LTRIM   RTRIM   TRIM
  469.      LOWER     UPPER   MID        LEFT    RIGHT
  470.  
  471.  - The following function(s) now take            BIGSTRs instead of STRINGs:
  472.  
  473.      LEN       INSTR
  474.  
  475.  - The following function(s) now          return BIGSTRs instead of STRINGs:
  476.  
  477.      SPACE     CHR
  478.  
  479.  - Added international currency and time support to PPL (based on the current
  480.      users language selection)
  481.  
  482.  - The FPUTPAD statement was misdocumented; it does not automatically write a
  483.      carriage return / line feed pair; if one is needed it must be written
  484.      with an FPUTLN statement
  485.  
  486.  - Added a command line switch (/NOUVAR) to PPLC to disable the automatic
  487.      generation of user variables
  488.  
  489.  - Added a command line switch (/NODISP) to PPLC to disable cursor
  490.      positioning during the compile (for example, this disables the
  491.      compilers whirly-gig)
  492.  
  493.  - A /DISARR switch was added to PPLC to disable array dimension
  494.      checking.  This allows a different number of subscripts to be
  495.      passed to array references without compiler errors or warnings.
  496.      Additionally it allows the REDIM statement to change the number of
  497.      subscripts used by a variable.  In other words, code like this
  498.      would be legal with the /DISARR command line switch:
  499.  
  500.      STRING s      ' Note no subscripts
  501.      REDIM s,5,5,5 ' Now it has subscripts
  502.      LET s(4,4,4) = "Hello, World!"
  503.      PRINTLN s(4,4,4)
  504.  
  505.      STRING s(1,1,1) ' Note three subscripts
  506.      REDIM s,5,5     ' Now it has two subscripts
  507.      LET s(4,4) = "Hello, World!"
  508.      PRINTLN s(4,4)
  509.  
  510.  - A comment may now be started by an asterisk (*) if it is the first
  511.      non-whitespace character on a line.
  512.  
  513.  - Source files can now be included from other source files.  This is
  514.      accomplished with a compiler directive in a comment like this:
  515.  
  516.       ;$INCLUDE:FILESPEC.EXT
  517.  
  518.    (Note that the first character need not be the semi-colon.  An
  519.      apostrophe ['] or asterisk [*] may also be used where appropriate.)
  520.  
  521.    This allows you to include subroutines from a source code 'library'.
  522.      This should help in starting reusable code fragments.  When the
  523.      file is included, it is compiled as though it were in the main
  524.      source file. For example:
  525.  
  526.       FOO.INC
  527.       -------
  528.       :subroutine
  529.       PRINTLN "Hello!"
  530.       RETURN
  531.  
  532.       FOO.PPS
  533.       -------
  534.       PRINTLN "Running FOO.PPS"
  535.       GOSUB subroutine
  536.       END ' This line is important!
  537.       *$INCLUDE:FOO.INC
  538.  
  539.    Note the use of END in FOO.PPS.  It is important in this case to
  540.      ensure that you don't accidentally run subroutine twice by just
  541.      falling through to it.
  542.  
  543.  - Added the file name to warning and error displays.  For example,
  544.      where the following error may have once been reported:
  545.  
  546.      Error in line number 123
  547.  
  548.    You will now get:
  549.  
  550.      Error in file FOO.PPS, line 123
  551.  
  552.    This is necessary for the new file include functionality.
  553.  
  554.  - Fixed a bug with the MAXNODE function where 2 would always be returned
  555.      regardless of the actual licensed copy in use
  556.  
  557.  - Fixed a bug with channel processing for the FPUTPAD statement which would
  558.      cause the statement to fail
  559.  
  560.  - Fixed a bug in array subscript processing that has existed since version
  561.    1.00.  The problem would occur only in multi-dimensional arrays and only if
  562.    an attempt was made to access the minimum and maximum column subscripts (0
  563.    and whatever was defined in the source code); a value written to one would
  564.    overwrite the other.
  565.  
  566.  - Added a BITCLEAR statement to clear a specified bit from a variable.
  567.    The syntax is:
  568.  
  569.      BITCLEAR variable,bit
  570.  
  571.    This statement is primarily intended to be used with BIGSTR variables
  572.    which can be up to 2048 bytes long.  However, it will work with other
  573.    data types as well if desired.  Just be aware of the potential
  574.    problems in 'bit twidling' non-string buffers and then trying to
  575.    access them later as their 'intended' type without re-initializing the
  576.    variable.  If the bit parameter (an integer from 0 to the number of
  577.    bits in the object) is invalid no processing takes place.
  578.  
  579.  - Added a BITSET statement to set a specified bit from a variable. The
  580.    syntax is:
  581.  
  582.      BITSET variable,bit
  583.  
  584.    This statement is primarily intended to be used with BIGSTR variables
  585.    which can be up to 2048 bytes long.  However, it will work with other
  586.    data types as well if desired.  Just be aware of the potential
  587.    problems in 'bit twidling' non-string buffers and then trying to
  588.    access them later as their 'intended' type without re-initializing the
  589.    variable.  If the bit parameter (an integer from 0 to the number of
  590.    bits in the object) is invalid no processing takes place.
  591.  
  592.  - Added an ISBITSET() function to check the status of a specified bit in
  593.    a variable.  The syntax is:
  594.  
  595.      ISBITSET(variable,bit)
  596.  
  597.    This function is primarily intended to be used with BIGSTR variables
  598.    which can be up to 2048 bytes long.  However, it will work with other
  599.    data types (and expressions) as well if desired.
  600.  
  601.  - Added a MOUSEREG statement to set up a RIP mouse region on the remote
  602.    terminal.  The syntax is:
  603.  
  604.      MOUSEREG num,x1,y1,x2,y2,fontX,fontY,invert,clear,text
  605.  
  606.        num    = Is the RIP region number
  607.        x1,y1  = The (X,Y) coordinates of the upper-left of the region
  608.        x2,y2  = The (X,Y) coordinates of the lower-right of the region
  609.        fontX  = The width of each character in pixels
  610.        fontY  = The height of each character in pixels
  611.        invert = A boolean flag (TRUE to invert the region when clicked)
  612.        clear  = A boolean flag (TRUE to clear and full screen the text window)
  613.        text   = Text that the remote terminal should transmit when the region
  614.                 is clicked
  615.  
  616.  - Added a MEGANUM() function to convert a decimal number (from 0 to
  617.    1295) to a hexa-tri-decimal number, or meganum.  The syntax is:
  618.  
  619.      MEGANUM(number)
  620.  
  621.  - Added a SCRFILE statement to find a file name and line number that is
  622.    currently on the screen.  The syntax is:
  623.  
  624.      SCRFILE lineVar,filenameVar
  625.  
  626.        lineVar     = Should be set before calling to the line number to start
  627.                      searching on (1 is the top line); Will be set to the line
  628.                      number where the file name was found or 0 if no file name
  629.                      was found
  630.        filenameVar = Will be set to the file name if one is found on screen
  631.  
  632.  - Added a SORT statement to sort the contents of an array into a pointer
  633.    array.  The syntax is:
  634.  
  635.      SORT sortArray,pointerArray
  636.  
  637.        sortArray    = The data to sort (Any type may be used for this array)
  638.        pointerArray = An integer array which will be used as an array of
  639.                       pointers into sortArray for accessing sortArray in
  640.                       sorted order (This array should be of type INTEGER)
  641.  
  642.    Note that sortArray and pointerArray are restricted to one (1) dimensional
  643.    arrays.
  644.  
  645.    The following is an example of displaying an array in unsorted and sorted
  646.    order:
  647.  
  648.      STRING  s(999) ; Remember that arrays are 0-based, so these statements
  649.      INTEGER p(999) ; will allocate 1000 elements each
  650.  
  651.      ; Do something here to read data into s
  652.  
  653.      SORT s,p
  654.  
  655.      INTEGER i
  656.  
  657.      FOR i = 0 TO 999 ; This loop will display in unsorted order
  658.        PRINTLN s(i)
  659.      NEXT
  660.  
  661.      FOR i = 0 TO 999 ; This loop will display in sorted order
  662.        PRINTLN s(p(i))
  663.      NEXT
  664.  
  665.  - Added an EVTTIMEADJ() function to detect if the users time has been
  666.    adjusted for an upcoming event.  This is useful to detect if a users
  667.    time left can be increased with the ADJTIME statement.
  668.  
  669.  - Added a SEARCHINIT statement to initialize search parameters for a
  670.    faster BOYER-MOORE search algorithm.  The syntax is:
  671.  
  672.      SEARCHINIT criteria,caseSensitive
  673.  
  674.        criteria      = A string expression with the search criteria in the same
  675.                        format used by PCBoard (ie, "THIS & THAT | BOB")
  676.        caseSensitive = A boolean flag (TRUE to force a case sensitive search,
  677.                        FALSE otherwise)
  678.  
  679.  - Added a SEARCHFIND statement to do a BOYER-MOORE search on a text
  680.    buffer using criteria previously defined with a SEARCHINIT statement.
  681.    The syntax is:
  682.  
  683.      SEARCHFIND bufferExpr,foundVar
  684.  
  685.        bufferExpr = The buffer to search
  686.        foundVar   = Set to TRUE if bufferExpr contains the search criteria,
  687.                     FALSE otherwise
  688.  
  689.  - Added a SEARCHSTOP statement to clear out previously entered search
  690.    criteria.  It takes no parameters.
  691.  
  692.  - Added PRFOUND and PRFOUNDLN statements.  These work just like PRINT
  693.    and PRINTLN but, if the last SEARCHFIND statement resulted in a match,
  694.    it will automatically highlight found words.
  695.  
  696.  - Added a TPAGET statement to get static information from a named TPA in
  697.    string format.  The syntax is:
  698.  
  699.      TPAGET keyword,infoVar
  700.  
  701.        keyword = The keyword of the TPA to use
  702.        infoVar = The variable into which to store the information
  703.  
  704.  - Added a TPAPUT statement to put static information to a named TPA in
  705.    string format.  The syntax is:
  706.  
  707.      TPAPUT keyword,infoExpr
  708.  
  709.        keyword  = The keyword of the TPA to use
  710.        infoExpr = The expression to write to store the TPA
  711.  
  712.  - Added a TPACGET statement to get information from a named TPA for a
  713.    specified conference in string format.  The syntax is:
  714.  
  715.      TPACGET keyword,infoVar,confNum
  716.  
  717.        keyword = The keyword of the TPA to use
  718.        infoVar = The variable into which to store the information
  719.        confNum = The conference number for which to retrieve information
  720.  
  721.  - Added a TPACPUT statement to put information to a named TPA for a
  722.    specified conference in string format.  The syntax is:
  723.  
  724.      TPACPUT keyword,infoExpr,confNum
  725.  
  726.        keyword  = The keyword of the TPA to use
  727.        infoExpr = The expression to write to store the TPA
  728.        confNum  = The conference number for which to retrieve information
  729.  
  730.  - Added a TPAREAD statement to get static information from a named TPA.
  731.    The syntax is:
  732.  
  733.      TPAREAD keyword,infoVar
  734.  
  735.        keyword = The keyword of the TPA to use
  736.        infoVar = The variable into which to store the information
  737.  
  738.  - Added a TPAWRITE statement to put static information to a named TPA.
  739.    The syntax is:
  740.  
  741.      TPAWRITE keyword,infoExpr
  742.  
  743.        keyword  = The keyword of the TPA to use
  744.        infoExpr = The expression to write to store the TPA
  745.  
  746.  - Added a TPACREAD statement to get information from a named TPA for a
  747.    specified conference.  The syntax is:
  748.  
  749.      TPACREAD keyword,infoVar,confNum
  750.  
  751.        keyword = The keyword of the TPA to use
  752.        infoVar = The variable into which to store the information
  753.        confNum = The conference number for which to retrieve information
  754.  
  755.  - Added a TPACWRITE statement to put information to a named TPA for a
  756.    specified conference.  The syntax is:
  757.  
  758.      TPACWRITE keyword,infoExpr,confNum
  759.  
  760.        keyword  = The keyword of the TPA to use
  761.        infoExpr = The expression to write to store the TPA
  762.        confNum  = The conference number for which to retrieve information
  763.  
  764.  - Added FMTREAL() function to format REAL/DREAL values for display purposes.
  765.    The syntax is:
  766.  
  767.      FMTREAL(realExp,fieldWidth,decimalPlaces)
  768.  
  769.        realExp       = A REAL/DREAL floating point expression
  770.        fieldWidth    = The minimum number of characters to display
  771.        decimalPlaces = The number of characters to display to the right of
  772.                        the decimal point
  773.  
  774.